package com.lncg.service;

import com.lncg.entity.CqzlDeviceReceiveData;

import java.util.List;

/**
 * CQZL设备接收数据服务接口
 * 
 * 定义CQZL设备数据的业务逻辑操作，包括数据解析、存储和历史记录管理。
 * 提供完整的CQZL协议数据处理流程。
 * 
 * @author LNCG
 * @version 1.0.0
 * @since 2024-10-17
 */
public interface ICqzlDeviceReceiveDataService {
    
    /**
     * 处理CQZL协议数据
     * 
     * 将CQZL协议数据转换为实体对象，执行UPSERT操作到主表，
     * 并插入历史记录到历史表。
     * 
     * @param jsonData CQZL协议的JSON数据字符串
     * @param clientIpPort 客户端IP和端口信息
     * @return 处理结果信息
     */
    String processCqzlData(String jsonData, String clientIpPort);
}
